sysError

Type

function

Summary

Returns the operating system's error status.

Syntax

the sysError

sysError()

Description

Use the sysError function to obtain the reason a command that makes an operating-system request failed.

On Unix systems, the sysError function returns the value of the "errno" variable.

On Windows systems, the sysError function returns the value returned by the "GetLastError()" function.

Examples

the sysError

if the sysError is zero then answer "Success!"

Value

Name	Type	Description
return		The sysError function returns an integer.
the result		Most operating system requests have to do with actions on files. For example, when you open a file or copy a resource, LiveCode requests the operating system to complete the action. If the action fails, the result is set to an error message, and the sysError function contains the error message the operating system reported to LiveCode. Note: When using the sysError function to check whether a command succeeded, be sure to check the result first. The sysError reports the operating system's error report, and some operating-system commands may report a value (and therefore set the sysError) even if the command succeeded. Only if the result is not empty does the sysError indicate that the command failed.

Related

command: close file, kill

control structure: function

function: result, sysError, value

glossary: error message, command, return, variable

keyword: integer

Compatibility and Support

Introduced

LiveCode 1.0

OS

mac

windows

linux

Platforms

desktop

server